home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 351-375 / disk_366 / loancalc / loancalc.doc < prev    next >
Text File  |  1992-05-06  |  11KB  |  261 lines
  1.  
  2.                              LoanCalc V1.2
  3.                              =============
  4.  
  5.  
  6. Although there are many mortgage calculation programs available, all that
  7. I have seen are designed around 'fixed' mortgages, ie. mortgages that have
  8. a fixed payment due on a fixed date.  As well as providing an Amortization
  9. Table for Fixed Mortgages with Monthly, Semi-Monthly, Bi-Weekly and Weekly
  10. payment schedules, LoanCalc (LC) is designed to track 'Open' mortgages 
  11. that allow any size payment to be made at any time.
  12.  
  13.  
  14. I apologize for the size of this program.  Being a 'weekend' programer,
  15. my programing style could not be described as elegant.  This program is 
  16. what you might call crude but effective.  Obviously written in AmigaBASIC, 
  17. it lacks the polish of other programs, but until a better program comes 
  18. along to do the same job, this one may fill the gap.  By the way, 
  19. if there is another program out there that does this, I would appreciate 
  20. if someone would let me know - I'll probably start using it.
  21.  
  22.  
  23. Since LC requires a lot of keyboard input anyway, it is entirely 
  24. keyboard driven (except for cancelling error messages, heaven forbid!).
  25. At any prompt, if 'R' is entered as the response, then LC will escape from
  26. the data entry mode and return to the Main Menu.
  27.  
  28.  
  29. If LC is launched from Workbench, icons will be created for all '.data' files
  30. created, in case you would like to edit the file.  These icons have no
  31. default tool, however, since I don't know which editor you would be using to 
  32. edit the file.  You can supply your own using the Workbench 'Info' Menu item.
  33.  
  34. If launched from the CLI, no icons are created.
  35.  
  36.  
  37. While running, LC will request a directory and filename under which the
  38. program data will be kept.  If no directory is specified, then obviously
  39. the Current Directory will be used.  Two files will then be generated
  40. in that directory.  One, 'Filename.data', will store all information
  41. regarding payments made, dates, interest paid, total interest, etc.
  42. The other, 'Filename.var', will store all the variables required by LC,
  43. which will vary from one session to the next.
  44.  
  45.  
  46. While entering data, there are lots of tiresome 'Are you sure?' type
  47. prompts, but although nobody likes them when the data is correct,
  48. they are useful in case of finger-trouble.
  49.  
  50.  
  51. LC opens on the Main Menu, where there are 8 selections:
  52.  
  53.      1.  Start a New Mortgage/Loan File
  54.      2.  Enter a Payment to an Existing Open-type File
  55.      3.  Re-Calculate the Same Loan   (Fixed-type only)
  56.      4.  View a Data File
  57.      5.  Send a File to the Printer
  58.      6.  Information
  59.      7.  About
  60.      8.  Quit
  61.  
  62. Just press the appropriate number on either number pad.
  63.  
  64.  
  65.  
  66.  
  67.  
  68. Selection 1 should be made if you have not already opened a file under
  69. the proposed filename, for example 'FirstMortgage', and there is no 
  70. 'FirstMortgage.data' and 'FirstMortgage.var' files in the specified
  71. directory.  A file will then be built from scratch.
  72.  
  73. The Open-type file will be built one entry at a time, using the data inputed.
  74. This option is good for Open Mortgages, Line of Credit type loans,
  75. or any loan that does not have a Fixed repayment schedule.
  76. This file cannot 'think ahead', because it cannot predict when your payments
  77. will be made, or exactly how large or how small they will be.
  78. Once a data entry has been made, you have the option of making another
  79. (Press any key), totaling the file (Left Alternate-Shift-T),
  80. or returning to the Menu (R).  Left Alternate-Shift-T merely prints 
  81. a footnote to the file, stating your Total Payments so far, and by how much 
  82. the Principal was reduced, and then returns you to the Menu.  It is intended 
  83. to be used after the last payment is made, but may be used beforehand.
  84.  
  85. The Fixed-type file will take all the parameters pertinent to your loan,
  86. and then display the Amortization Table for that loan for any period
  87. from one month, up to the Amortization Period of the loan.
  88. If you are allowed to make lump sum payments to your Fixed loan, then run
  89. the Amortization Table for a number of months such that the last payment
  90. displayed is the date on which the lump sum payment is to be made.
  91. The Principal reduction will be made on that date.  Since all payments must
  92. be made in chronological order, once the Amortization Table has been
  93. displayed for a month beyond one in which you want to make a 
  94. lump sum payment, you would have to go back to Selection 3,
  95. and re-select the number of months to display.
  96.  
  97.  
  98. Selection 2 should be made to enter more payments to an Open Mortgage/Loan
  99. file which has already been opened with Selection 1.  Although there is a 
  100. provision to make lump payments on a Fixed-type loan, that is not done using
  101. this Menu item.  Just enter the filename at the prompt, or if re-entering 
  102. the current file, just hit <Return>.
  103.  
  104.  
  105. Selection 3 is for Fixed-type loans only.  If you have already entered the
  106. Mortgage/Loan parameters (Principal, Interest Rate, Commencement Date,
  107. Interest Compound Period and Filename), the LC will use these numbers,
  108. ask for confirmation, and request the Amortization Period/Monthly Payment.
  109. Any changes to these parameters may be made at this time.
  110. In this way, the same numbers can be quickly 'fiddled' to show various
  111. combinations of these variables.  This feature cannot be used for Open-type
  112. loans for the reason mentioned above - Open loans cannot be predicted.
  113.  
  114.  
  115. Selection 4 will ask for the filename of the file you want to View.
  116. Enter the filename as it was entered when the file was created in Selection 1,
  117. without the '.data' or '.var' extensions, or just hit <Return> as prompted
  118. if the desired file is the current file.  If the file is not in the
  119. Current Directory, then naturally the path will have to be included.
  120. You may then see the file almost exactly as it will look when printed
  121. using the following selection.  (The printed version will be page formated).
  122. The data you will be looking at is the same data that was put on the screen;
  123. if it wasn't on the screen, it won't be in the file. So if you want to see
  124. (or print) the whole Amortization Table in the data file, press <Return>
  125. when when prompted 'Amortization Table for how many months', so that
  126. the whole Table will be calculated and displayed.
  127.  
  128. A text reader such as the enclosed View program would be ideal for looking at
  129. these files, as you may have noticed if you have examined the sample files
  130. enclosed with this program.  However, I wanted the program to be completely 
  131. stand-alone, and so opted to include the primitive forward-only viewer.
  132.  
  133.  
  134.  
  135. Selection 5 will ask for the filename of the file you want printed.
  136. Enter the filename as in the previous selection.  The 'Filename.data' file 
  137. for the requested filename will then be sent to the PRT: device.
  138.  
  139.  
  140. Selection 6 just recaps some of the information in this file, in case
  141. nobody reads it.
  142.  
  143.  
  144. Selection 7 tells you who to blame if something goes wrong.
  145.  
  146.  
  147. Selection 8 Exits the program.
  148.  
  149.  
  150.  
  151. I have included woth this program 4 sample '.data' files to give you an idea 
  152. of what your print-out will look like.  The 4 files represent the same
  153. $100,000 mortgage, with an Interest Rate of 12.75%, amortized over 5 years,
  154. and includes one lump sum payment made on the second anniversary of the loan.
  155. One shows the Amortization Table if you had chosen to repay the mortgage
  156. with Monthly payments, another with Semi-Monthly payments, and the others
  157. with Bi-Weekly and Weekly payments.
  158.  
  159.  
  160.  
  161.                              The Print-Out
  162.                              -------------
  163.  
  164. The 'Payment' date shown for each payment will depend on the type of
  165. Mortgage/Loan you select, as follows:
  166.  
  167. Open Mortgages will naturally show the payment on whatever date you enter.
  168.  
  169. Fixed Mortgages:
  170.  
  171. If you choose to make Monthly Payments, then the payments will be shown
  172. as due on the day of the month that the loan was taken out.  So if you
  173. want payments due on the 1st of the month, show the loan as starting
  174. on the 1st day of the previous month.  
  175.  
  176. Semi-Monthly Payments are always shown as due on the 1st and 15th day
  177. of the month.
  178.  
  179. Bi-Weekly Payments are shown as first due 14 days after the starting date
  180. of the loan, and due every 14 days thereafter.
  181.  
  182. Weekly Payments are shown as first due 7 days after the starting date
  183. of the loan, and due every 7 days thereafter.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                LIMITATIONS
  202.                                -----------
  203.  
  204. Some limitations of LC are:
  205.  
  206. All data entries MUST be in chronological order.  
  207. (I just plain didn't know how to avoid this).
  208.  
  209. An entry must be made for every 6 months or so.  This as necessary to
  210. keep the year-ends straight, so that LC knows which are leap-years.
  211. (The formula is slightly different in leap-years).
  212.  
  213. There is a bug that seems to crop up every now and again.
  214. As LC is writing some information to a .data or .var file,
  215. a FILE ALREADY OPEN error will sometimes pop up.  As all of my OPEN
  216. commands are immediately preceded by a CLOSE command on the same line,
  217. I am confused as to why this would happen.  (A lot of YOU probably know,
  218. but I don't).  At any rate, I built a RESET command into the 
  219. Error Handler, which seems to work well enough to allow the file to be
  220. rebuilt from Menu Item 3, rather than have to start from scratch at
  221. Menu Item 1.
  222.  
  223.  
  224.  
  225.                 Files included with this program:
  226.                 ---------------------------------
  227.  
  228. LoanCalcV1.2                                 LoanCalcV1.2.info
  229. LoanCalc.doc                                 LoanCalc.doc.info
  230. Monthly.data                                 Monthly.data.info
  231. Semi-Monthly.data                            Semi-Monthly.data.info
  232. Bi-Weekly.data                               Bi-Weekly.data.info
  233. Weekly.data                                  Weekly.data.info
  234. View - the PD text reader by Bryan Ford (available on Fred Fish disk #163).
  235.  
  236.  
  237.  
  238. I would like to take this opportunity to add my voice to the chorus of
  239. roughly one million others out there, and thank Fred Fish for the
  240. wonderful work he is doing on behalf of all Amiga owners.
  241.  
  242. My thanks also to all of the PD authors out there who so generously donate
  243. the fruits of their labour for the enjoyment of others.  People like
  244. Bryan Ford and Dick Taylor, who wrote the BREF program forthe Amiga,
  245. (available on Fred Fish disk #283), I believe are the heart and soul
  246. of the Amiga.  Thank you ALL.
  247.  
  248.  
  249.  
  250. Hope someone finds this useful.
  251.  
  252.  
  253.  
  254. Any comments, problems or bug reports are welcome.  Please send to:
  255.  
  256.  
  257.             Robert Bromley
  258.             4080 Longo Circle
  259.             Malton, Ontario
  260.             CANADA  L4T 4C7
  261.